home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / comunic / zcomm.zip / ZCOMMDOC.AG < prev    next >
Text File  |  1993-11-27  |  77KB  |  1,771 lines
  1.  
  2.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                  181
  4.  
  5.       BELL Generates a tone in the speaker unless visual bell display is
  6.         enabled ("display bell=visual").  If the display has fallen behind
  7.         the incoming data, ZCOMM suppresses the bell due to the relatively
  8.         long time required to perform a bell ring.  If a file is being
  9.         transmitted with the term function, a bell character will pause
  10.         transmission for a short time.  (Some computers send bell characters
  11.         to indicate their input buffers are becoming overloaded.)
  12.  
  13.       FF If c term option is enabled, erase the screen.
  14.  
  15.       XOFF Suspends file transmission from ZCOMM.  XOFF is excluded from
  16.         pattern searches and does not display unless v term option is set.
  17.         After a timeout determined by the Kermit s numeric parameter
  18.         (default 60 seconds), transmission will resume even if no XON
  19.         character is received.[3]
  20.  
  21.       XON Resumes file transmission from ZCOMM.  XON is excluded from
  22.         pattern searches and does not display unless v term option is set.
  23.  
  24.       NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
  25.         in i (image) or v term option.  They are excluded from pattern
  26.         searches.
  27.  
  28.       21.5  Buffer Writing
  29.  
  30.       If e (Emacs) term option is set, a buffer dump is performed before
  31.       each keyboarded character is sent to the remote, since normal XOFF
  32.       based flow control is assumed to be disabled.
  33.  
  34.       When the free space in the circular buffer is nearly exhausted, ZCOMM
  35.       sends an XOFF character to the remote[4] and writes the buffer
  36.       contents to the receive file[5] (if any).  The circular buffer is also
  37.       written to the receive file as a result of a "w" command, ALT-W key,
  38.       or once per second if j term option is in effect.
  39.  
  40.       When the circular buffer is written to a receive file, several control
  41.       characters are treated specially if i (image) term option is not set.
  42.       Iff s term option is set, all control characters, except for those
  43.       listed below, are excluded from the received file.
  44.  
  45.  
  46.  
  47.       __________
  48.  
  49.        3. There is no timeout if the parameter is 0.
  50.  
  51.        4. Assuming e term option is not in effect.
  52.  
  53.        5. An XON is sent to the remote after this automatic buffer write
  54.           operation.
  55.  
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  59.  
  60.  
  61.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                  182
  63.  
  64.       NULL ACK BELL XON XOFF RUBOUT ESC These characters are excluded from
  65.         the file.  Most "escape sequences" are also filtered form the
  66.         cpature file.  NULL, DELETE, XON, and XOFF are excluded from pattern
  67.         searches.
  68.  
  69.       ETX, EOT These characters close the file if q term option is in
  70.         effect, as when ZCOMM is receiving a message in host state using TWX
  71.         protocol.
  72.  
  73.       Ctrl-Z (CPMEOF) Iff z term option is enabled, close the file.
  74.         Otherwise this character is discarded.
  75.  
  76.       LF Iff n (nlmode) term option is on, a CR is written to the file
  77.         before the LF.  Linefeed is always passed to the file.
  78.  
  79.       CR Iff a term option is in effect, a CR LF sequence is written to the
  80.         file.  Otherwise, if s term option is on, CR is only written to the
  81.         file as a response to an LF in the circular buffer.
  82.  
  83.       BS Backspace is written to the file unless s term option is in effect,
  84.         in which case it, and the last character written in the disk file,
  85.         are deleted by backspacing the file write pointer.  This simulates
  86.         the function of backspace on common CRT terminals.
  87.         NOTE: This backspacing of the file write pointer operates the same
  88.         as Teco and Emacs editors; it does not stop at the beginning of the
  89.         line.  Backspacing over tab characters is tricky because it may take
  90.         several backspaces to eliminate the spaces corresponding to one tab
  91.         character, but only one is needed to eliminate the tab character in
  92.         the output file.
  93.  
  94.       HT, FF These characters are always passed to the file, even if s term
  95.         option is in effect.  If ss term option is in effect, FF is not
  96.         passed to the file.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                         Chapter 21 Term Options
  118.  
  119.  
  120.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                  183
  122.  
  123.       22.  Term Function OPTIONS
  124.  
  125.       The term function options described in this chapter affect the
  126.       operation of the f, put, wait, and t commands.  The b, n, p, r, w
  127.       options are mutually exclusive.
  128.  
  129.       All options except f and n are reset by the call and init commands.
  130.  
  131.       Term function options may be set with flags to the conference, create,
  132.       enable, disable, f, open, t, and wait commands.
  133.  
  134.       The call command resets ZCOMM and the communications port to 8 bits no
  135.       parity.
  136.  
  137.       !  Negates the sense of the following options.  The !  modifier is not
  138.          used with the 7 and 8 options.
  139.  
  140.          EXAMPLE: t -Z!tl enables ZMODEM AutoDownload and turns off throttle
  141.          and line printer output.
  142.  
  143.  
  144.       7e 7o 7m 7s Sets 7 bits plus {Even Odd Marking Spacing} parity for
  145.          transmission with the put, f, and t commands, and file transfers
  146.          using the Kermit protocol.  The parity setting does not affect the
  147.          information content of received characters.[1] If 7e or 7o option
  148.          is used, each incoming byte of Kermit packets is checked for parity
  149.          for extra accuracy in file transfers.
  150.  
  151.          Some applications require 7 bit transmission.  Even parity is often
  152.          used for TWX and IBM mainframe communications.  7m option sets the
  153.          parity bit to "marking" (8th bit set to ONE), sometimes used with
  154.          DEC minicomputers and IBM mainframes.
  155.  
  156.          7s option masks data transmitted by the term function to 7 bits
  157.          (spacing is equivalent to binary 0).
  158.  
  159.          If a paritied option is specified, the term function counts each
  160.          character received with the opposite parity as an uncorrected
  161.          error.
  162.  
  163.          The call command resets ZCOMM and the communications port to 8 bits
  164.          no parity (8n).
  165.  
  166.          EXAMPLE: ena -E7e enables Error Containment(TM) with 7 bits even
  167.  
  168.  
  169.       __________
  170.  
  171.        1. The term function normally strips the parity bit unless 8g
  172.           (graphics) option is set.
  173.  
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  177.  
  178.  
  179.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                  184
  181.  
  182.          parity.
  183.  
  184.  
  185.          SEE ALSO: E mode
  186.  
  187.       8n Sets 8 bits no parity (default) for transmission with the Kermit,
  188.          and t commands.  The call command resets ZCOMM and the
  189.          communications port to 8 bits no parity (8n).
  190.  
  191.       8g Some PC based bulletin boards send line drawing characters intended
  192.          for IBM display adapters encoded with the 8th bit set.  8g term
  193.          option uses 8 data bits with no parity.  All 8 bits are also passed
  194.          to the display, allowing the special graphics characters to be
  195.          displayed, including those sent by many IBM-PC bulletin boards.  8g
  196.          term option must not be used when the remote is sending 7 bits with
  197.          marking, even, or odd parity,
  198.  
  199.       8o 8e 8e sets the hardware to 8 bits even parity; 8o sets the hardware
  200.          to 8 bits odd parity.* The 8e and 8o term option ares used only
  201.          with very specialized applications.  No known dial-up systems use
  202.          either of these options.  Most modems do not support 8e or 8o
  203.          option.
  204.  
  205.          SEE ALSO: 7e and 7o options
  206.  
  207.       A  Sends characters from the remote to DOS, bypassing ZCOMM's CRT
  208.          driver.  A option allows a screen driver such as FCONSOLE.DEV to
  209.          pcocess extended ANSI or special terminal codes which ZCOMM would
  210.          not otherwise understand.  The A option affects the term function
  211.          only.  When using the A option, the term function status line
  212.          should be disabled with a "display stat=off" command if the display
  213.          driver uses all 25 CRT lines.  Fansi-Console(TM) or other drivers
  214.          with definable scrolling regions may be set to scroll only the top
  215.          24 lines, leaving the 25th line free for ZCOMM's status
  216.          information.
  217.          WARNING: Fansi-Console and ANSI.SYS allow input data from the
  218.          remote to redefine keys and/or cause commands to be executed.  Such
  219.          capabilities pose a security breach.  For example, an innocuous
  220.          looking message could contain an invisible escape sequence to make
  221.          your "keyboard" issue "del \COMMAND.COM" the next time you strike
  222.          the ESC key.
  223.  
  224.          EXAMPLE: display stat=off;  t -A disables Zcomm's status line and
  225.          routes characters from the remote to DOS standard output.
  226.  
  227.  
  228.          SEE ALSO: list command
  229.  
  230.       a  Addlf adds a linefeed to each carriage return received from the
  231.          remote.  This is displayed as newline (return/linefeed).  The same
  232.          action takes place if addlf is in effect when the term function is
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  236.  
  237.  
  238.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                  185
  240.  
  241.          writing the circular buffer to a file.  This term option is useful
  242.          when the data from the remote contains carriage returns but no
  243.          linefeeds.  The a term option may be used with the s (Strip control
  244.          characters) term option.
  245.          NOTE: i (image) term option supersedes a term option.
  246.  
  247.          EXAMPLE: read nolffile.txt; create -a withlf.txt; w; close reads
  248.          nolffile.txt into the circular buffer, then writes it to withlf.txt
  249.          with linefeeds added.
  250.  
  251.  
  252.       b  Binary term option of file transmission with the f file command.
  253.          All 8 bits are sent.  This is handy for uploading binary files
  254.          using the f command to adjacent machines without any useful file
  255.          transfer protocol.
  256.  
  257.          Don't confuse this mode with the protocol file transfer commands
  258.          which send files with error correcting protocols.  Also don't
  259.          confuse this with the i term option which affects files received
  260.          with the term function.
  261.          NOTE: The fput command can also be used to send a binary file when
  262.          no monitoring of the remote's responses is needed.
  263.  
  264.          EXAMPLE: f -b binfile
  265.  
  266.  
  267.       c, C Compuserve mode allows the remote computer to invoke the
  268.          Compuserve B protocol.  c causes formfeed from the remote to clear
  269.          the screen, C does not.  When enabled with c or C term option, the
  270.          Compuserve B protocol uses ENQ and DLE for special functions.
  271.  
  272.          EXAMPLE: t -c
  273.  
  274.  
  275.          SEE ALSO: w numeric parameter
  276.  
  277.       D  Delays detection of carrier detect loss.  * When carrier detect is
  278.          lost, D term option causes ZCOMM to wait up to two seconds for
  279.          carrier detect to return.  If carrier detect returns within that
  280.          two seconds, ZCOMM pauses another two seconds to allow the modems
  281.          time to stabilize.  D term option allows file transfers to continue
  282.          in the presence of interruptions from call waiting or cellular
  283.          radio communications dropouts.  The modem's carrier dropout timer
  284.          must be lengthened to two seconds to accomodate such droputs
  285.          without disconnecting by adding a Hayes S10=20 command to the modem
  286.          initialization string sent by the dial telephone directory entry.
  287.  
  288.       d  (Dropout) Disables the No Carrier Detect message otherwise
  289.          generated by the term function and protocol file transfers when the
  290.          communications port detects a loss of carrier detect.  This term
  291.          option is useful when operating with direct connections that do not
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  295.  
  296.  
  297.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                  186
  299.  
  300.          properly drive the carrier detect line.  The call command sets d
  301.          term option; the standard dialing scripts cancel it when the modem
  302.          reports a connection.
  303.          NB: Enabling d mode disables the term function from checking for
  304.          loss of carrier detect signal.  Disabling d mode enables this
  305.          checking.
  306.  
  307.          EXAMPLE: ena -d
  308.  
  309.  
  310.       E  Error Containment(TM) When the remote is transmitting continuously,
  311.          a single "line hit" may garble many characters before the hardware
  312.          can recover.  E term option makes the term function send an XOFF
  313.          (^S) character to stop the transmission of data when a "line hit"
  314.          is detected.  A line hit is detected by the presence of a break
  315.          signal or framing error.  If the 7e, 7o, 7m, or 7s term option is
  316.          set, ZCOMM also detects parity errors as line hits.[2] After a
  317.          brief pause, an XON (^Q) is sent to resume transmission.
  318.  
  319.          E term option does not effect protocol transfers.  It is effective
  320.          only when the remote recognizes XOFF to stop transmission.  E term
  321.          option cannot be used with programs such as EMACS which use ^S and
  322.          ^Q as editing commands; it should not be used with X.PC.
  323.  
  324.          EXAMPLE: create -+E7e capture.fil creates capture.fil for output,
  325.          appending it to any existing instance of the file, enabling 7 bits
  326.          even parity and Error Containment.
  327.  
  328.  
  329.          SEE ALSO: E and e numeric parameters
  330.  
  331.       e  EMACS editors and a few other programs use the ASCII flow control
  332.          characters XON and XOFF as commands.  These characters cannot be
  333.          used for their normal flow control functions with EMACS.  Emacs
  334.          term option suppresses the automatic transmission of XOFF (^S) and
  335.          XON (^Q) when ZCOMM's circular buffer fills up.  Opening a receive
  336.          file with the t file command cancels EMACS term option, but it may
  337.          be turned back on later.  ("t -e file" won't activate e term
  338.          option.)
  339.  
  340.          When capturing data to a file with e (Emacs) term option on, the
  341.          user must manually stop the data from the remote and dump the
  342.          buffer with the w command or the Alt-W key.  Keyboarded characters
  343.  
  344.  
  345.       __________
  346.  
  347.        2. Many medium speed modems, including 1200 and 2400 bps units, do
  348.           not generate framing errors in response to line hits.  When such
  349.           modems are used, parity must be used to detect line hits.
  350.  
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  354.  
  355.  
  356.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                  187
  358.  
  359.          automatically trigger a buffer write.
  360.  
  361.          EXAMPLE: create capturefile; t -e
  362.  
  363.  
  364.          SEE ALSO: j mode
  365.  
  366.       f  Full duplex.  ZCOMM does not echo keyboarded characters to the
  367.          screen.
  368.  
  369.       FN Overrides the default pattern match fail time for the current wait
  370.          command to N seconds absolute.  A value of 0 suppresses this
  371.          timeout.
  372.  
  373.          EXAMPLE: wait -F5 searches for a pattern match, and will fail after
  374.          five seconds.
  375.  
  376.  
  377.       fN Sets the pattern match fail time for the current wait command to N
  378.          seconds of inactivity.  A value of 0 suppresses this timeout.
  379.  
  380.          EXAMPLE: wait -f5 searches for a pattern match, and will fail after
  381.          five seconds of inactivity.
  382.  
  383.  
  384.          SEE ALSO: f numeric parameter
  385.  
  386.       g  resumes sending the file once in the term function, equivalent to
  387.          an XON character.  Disabling g causes a file queued for
  388.          transmission to wait for an XON character.  Enabling g mode (ena
  389.          -g) will resume file transmission after a grab command.
  390.  
  391.          SEE ALSO: grab command
  392.  
  393.       G, GG G term option (the default) allows the term function to
  394.          recognize XON and XOFF flow control.  A number of characters may be
  395.          sent before ZCOMM responds to XOFF.  GG term option prevents the
  396.          term function from recognizing XON and XOFF flow control.
  397.  
  398.          As a special case, disabling G term option allows the interrupt
  399.          driven output routines in ZCOMM to respond immediately to XOFF and
  400.          XON characters instead of waiting for the term function to receive
  401.          and act upon them.  A consequence of this selection is that the
  402.          term function may be "stuck" waiting for the interrupt level
  403.          routines, while at the same time the interrupt level routines are
  404.          "waiting" for an XON character.  A spurious XOFF or lost XON
  405.          character can cause this deadlock.  The S numeric parameter should
  406.          be set to an appropriate value to allow timeout and recovery from
  407.          this condition.
  408.  
  409.          EXAMPLE: f -!G asciifile.txt
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  413.  
  414.  
  415.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                  188
  417.  
  418.       H,h Half Duplex Displays keyboarded characters as they are sent to the
  419.          host.  H term option causes keyboarded carriage return to be echoed
  420.          as cr/lf.
  421.  
  422.          Two half duplex term options are provided to match computer systems
  423.          that send a linefeed in response to carriage return ("t -h") and
  424.          others that give no echo at all to carriage return ("t -H").
  425.  
  426.          SEE ALSO: h numeric parameter
  427.  
  428.       i  If a file is being received with the Term function, Image term
  429.          option allows all characters received, including NULLS, to be
  430.          output when the capture buffer is written to disk.  Image term
  431.          option makes the review function act upon ESCAPE characters.  Image
  432.          term option overrides the a, s and z term options.  Image term
  433.          option does not override the A, c, C or Z term options, and does
  434.          not control the parity bit.  Image option causes capture files
  435.          opened with the -+ (append) option to preserve all data currently
  436.          present in the disk file, including any CP/M EOF characters.
  437.  
  438.          EXAMPLE: t -i
  439.  
  440.  
  441.          SEE ALSO: I, v and 8g term options, ALT-I key, fget command
  442.          The fget command is faster as there is no display of the received
  443.          data.
  444.  
  445.          Image term option does not affect transmitted data.[3]
  446.  
  447.       I  Super Image term option sets completely transparent 8 bit data
  448.          capture with the term function.  In addition, the A, c, C, and Z
  449.          term options are superceded, XON, XOFF, ENQ are not executed.
  450.          Super Image term option is useful for capturing binary data from
  451.          sources that require keyboard or script intervention.  If the
  452.          incoming data contains random escape sequences, ZCOMM's terminal
  453.          emulation decoding of escape sequences should be suppressed.
  454.          Either v term option should be set, or a display dumb command
  455.          should be given.
  456.  
  457.       J  On Unix and Xenix systems, the J term option smooths the display of
  458.          data coming from slow serial lines by accepting data in smaller
  459.          chunks.  It may be used for interactive applications where jerky
  460.          output is unesthetic.  J term option increases CPU utilization and
  461.          context switching overhead.
  462.  
  463.  
  464.       __________
  465.  
  466.        3. The b (Binary) term option modifies files transmitted with the
  467.           term function.
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  472.  
  473.  
  474.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                  189
  476.  
  477.          SEE ALSO: ALT-J
  478.  
  479.       j  * The jabberwrite term option causes the term function to dump the
  480.          circular buffer to disk once a second if a receive file is open,
  481.          without interrupting the data flow from the remote.  This avoids
  482.          the delay required when dumping the entire buffer to disk, but may
  483.          cause loss of data if the output device is too slow, or if its
  484.          driver software inhibits data interrupts from the remote.  It
  485.          should not be used with the PCjr because the PCjr disk cannot
  486.          overlap i/o with disk activity.
  487.  
  488.          EXAMPLE: t -j
  489.  
  490.  
  491.       K  Enables automatic downloading of files with the Kermit protocol.
  492.          The y term option applies to Kermit AutoDownload.
  493.  
  494.       l  (letter l) List unit (Printer) on.  Since ZCOMM buffers the
  495.          printer, it needn't be as fast as the incoming data as long as the
  496.          buffered data doesn't exceed the circular buffer size.  The rewind
  497.          command may be used to get extra copies of the received data
  498.          (assuming it all fits in the circular buffer).  The list unit is
  499.          accessed with the rom bios printer interface (int 17h).
  500.  
  501.          EXAMPLE: t -l enables printer spooling.
  502.  
  503.  
  504.          EXAMPLE: disable -l disables printer spooling.
  505.  
  506.          NOTE: If ZCOMM is terminated before all of the circular buffer is
  507.          output to the printer, the remainder of the data will be lost.
  508.  
  509.          SEE ALSO: The ALT-L key toggles printing starting with next
  510.          character received from the remote.  The l numeric parameter
  511.          selects the printer device.  The lpnono string parameter allows
  512.          unwanted control characters to be filtered from the printer.
  513.  
  514.       n  sends newline (lf) only when transmitting a file with the term
  515.          function (no CR).  Keyboarded CR is sent as a newline.  When
  516.          receiving a file to disk with the term function, Newline is stored
  517.          on disk as CR LF.  n term option causes newlines to be displayed as
  518.          CR LF.  The n term option is not reset by the call command.
  519.  
  520.          EXAMPLE: f -n file
  521.  
  522.  
  523.       p,P When transmitting a file with the term function, the contents of
  524.          eolstr (CR by default) are sent at the end of each line.  Prompt
  525.          term option then waits for a prompt character ( g numeric
  526.          parameter[4]) from the remote after each line transmitted from a
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  531.  
  532.  
  533.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  190
  535.  
  536.          file.  If GOchar is not received, the wait times out and
  537.          transmission proceeds in the same manner as with w term option.
  538.          The duration of this timeout is controlled by the p numeric
  539.          parameter.  The q numeric parameter controls the pause between
  540.          recognizing GOchar and resuming transmission.  This pause is not
  541.          reset by characters from the remote.
  542.  
  543.          EXAMPLE: f -p file
  544.  
  545.  
  546.          SEE ALSO: g, p, q numeric parameters
  547.  
  548.          As a convenience, P term option implicitly sets GOchar to 17.  As a
  549.          special case, if GOchar is set to 17 (called XON, DC1, or ^Q)
  550.          before the p term option is set, file transmission is stopped until
  551.          an XON is keyboarded or received from the remote.
  552.  
  553.          EXAMPLE: f -P file
  554.  
  555.  
  556.       q  (TWX term option) Setting q term option causes the term function to
  557.          guarantee the contents of the circular buffer have been written to
  558.          disk[5] and then transmit the answerback string parameter in
  559.          response to ENQ.  An ACK from the local keyboard or a transmitted
  560.          file also transmits the answerback.  An EOT or carrier loss closes
  561.          the receive file and exits the term function.
  562.  
  563.       Q  Quiet inhibits the term function display of data from the remote.*
  564.          The status line, ZCOMM messages, and output from utility commands
  565.          are not affected.  The Q term option may be used to suppress
  566.          unwanted characters during modem initialization, logins, etc.
  567.  
  568.          SEE ALSO: display inhibit command
  569.  
  570.       r  CR term option sends the contents of eolstr (CR by default) at the
  571.          end of each line transmitted from a file with the f command.  There
  572.          is no pause at the end of each line.
  573.  
  574.          EXAMPLE: f -r file
  575.  
  576.  
  577.  
  578.  
  579.       ______________________________________________________________________
  580.  
  581.        4. The default for numeric parameter g (GOchar) is linefeed .
  582.  
  583.        5. On DOS, the file is written, closed, and reopened.  The TWX
  584.           protocol assumes that transmitted information has been safely
  585.           stored before an answerback is sent in response to ENQ.
  586.  
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  590.  
  591.  
  592.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  191
  594.  
  595.       S  SuperStrip term option strips Form Feed (FF) from the file in
  596.          addition to the actions of s term option.
  597.  
  598.          EXAMPLE: t -S capture.txt
  599.  
  600.  
  601.       s  Strip all Control Characters except LF, FF, HT, and BS when
  602.          capturing to a file with the term function.  Most escape sequences
  603.          are completely removed, especially common ANSI codes for setting
  604.          colors and positioning.  In s term option, a BS character causes
  605.          ZCOMM to attempt to erase the previous character from the output
  606.          file with an fseek() function call.  This is guaranteed to work
  607.          only if the output is to a disk file and sufficient characters come
  608.          after the BS to overlay the "erased" character.[6] An LF is stored
  609.          in the file as CR LF to make up for the CR that is discarded in s
  610.          term option.  XON, XOFF, and DEL (RUBOUT) do not display when s
  611.          term option is in effect.  The a (Addlf, add linefeed to carriage
  612.          return) term option may be used with the s term option.
  613.          NOTE: i (image) term option supersedes s term option editing.
  614.  
  615.          When displaying file(s) with the cat, more, type, page, bro/v, and
  616.          bro/p commands, stop when ^Z (CP/M EOF) is read.
  617.  
  618.       sss In addition to the above, sss inhibits the display of blank lines.
  619.  
  620.          SEE ALSO: display vt100 command
  621.  
  622.       t  Some remote systems cannot accept input at full speed.  Throttle
  623.          term option slows the sending of characters to the remote.  The
  624.          speed is controlled by the t numeric parameter.  The default value
  625.          slows transmission to about 50 words per minute.  The t term option
  626.          does not affect protocol transfers.
  627.  
  628.          EXAMPLE: f -t command.fil
  629.  
  630.  
  631.          SEE ALSO: t numeric parameter
  632.  
  633.       TN Sets the pattern match fail time for the current wait command to N
  634.          seconds absolute.  In addition, the term function will return
  635.          (without matching any patterns) after an enabled Kermit,
  636.          Compuserve-B, or ZMODEM automatic file transfer (successful or
  637.          otherwise).
  638.  
  639.          EXAMPLE: wait -T99 searches for a pattern match, and will fail
  640.  
  641.  
  642.       __________
  643.  
  644.        6. This backspace simulation does not stop at a virtual left margin.
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  649.  
  650.  
  651.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  192
  653.  
  654.          after 99 seconds.
  655.  
  656.  
  657.       u  Enables Upper case conversion of keyboard and file characters sent
  658.          with the term function (t, f, F2 commands).  The answerback and
  659.          programmed strings are not affected.  Protocol file transfers are
  660.          not affected.
  661.  
  662.          EXAMPLE: ena -u
  663.  
  664.  
  665.          SEE ALSO: ALT-U key
  666.  
  667.       v  View control characters as ^C.  In addition to the above, vv term
  668.          option denotes characters with the parity bit set by prepending a
  669.          tilde (~).  Finally, vvv term option prints incoming characters in
  670.          hex.* The v term option override the A, c, C, and Z term option.
  671.  
  672.          EXAMPLE: t -iv bincapt.fil captures binary data from the modem to
  673.          bincapt.fil, with control characters displayed legibly.
  674.  
  675.          NOTE: View term option is distinct from the file transfer view
  676.          option.
  677.  
  678.       V  On VMS create capture files with VMS variable length CR carriage
  679.          return record format.  The default is Stream_LF record format.
  680.  
  681.       w  Wait term option.  When sending files with the term function, send
  682.          the contents of eolstr (CR by default) at the end of each line, and
  683.          then wait until echoes from the remote have stopped.  Useful for
  684.          sending files to bulletin boards where the remote needs time to
  685.          prepare for the next text line.  The p numeric parameter controls
  686.          the length of this wait, which is reset by each character received
  687.          from the remote.
  688.  
  689.          EXAMPLE: f -w file
  690.  
  691.  
  692.       W  Enable writing from the circular buffer to capture file (default
  693.          enabled).* The echof and echoc commands are not affected.
  694.  
  695.          SEE ALSO: ki command
  696.  
  697.       x,X EXit from the term function when EOF is encountered on transmitted
  698.          file.  In addition, X term option causes the term function to exit
  699.          when the file upload is interrupted by reading a character matching
  700.          the value of the m numeric parameter.  The x term option is the
  701.          standard way for a script to regain control after uploading a file
  702.          with the term function.
  703.  
  704.          EXAMPLE: f -x upload.txt
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc                         Chapter 22 Term Options
  708.  
  709.  
  710.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  193
  712.  
  713.          SEE ALSO: m numeric parameter
  714.  
  715.       y  Yes it is OK to clobber a file already on disk when receiving to a
  716.          file.  If absent, the operator is given a choice of appending to
  717.          the current file (a), erasing it (y) or aborting (n).  This term
  718.          option is reset at each command line and at each obey and function
  719.          key, pattern action, or downloaded command.  This term option is
  720.          not allowed if ZCOMM is Restricted.
  721.  
  722.       Z  (Case is significant!) enables ZMODEM AutoDownload of commands and
  723.          files when the term function is active (this is the default).  The
  724.          term function recognizes ZMODEM AutoDownload at 300 bps and higher
  725.          speeds.
  726.  
  727.          EXAMPLE: dis -Z disables ZMODEM AutoDownload.
  728.  
  729.  
  730.          ZMODEM AutoDownload performs a security check to reject Trojan
  731.          Horse messages.  The challenge may be disabled with an ena -yZ
  732.          command, resulting in a time savings when using some modems.
  733.  
  734.       z  Close file when CPMEOF (^Z) is encountered while writing the
  735.          capture buffer.  On DOS flavors, z term option also appends a
  736.          CTRL-Z (CP/M EOF) to the end of files created with the apd, create,
  737.          t file, browse/a, browse/A, review/w, review/W, and > commands.
  738.          Otherwise, ^Z is ignored.
  739.  
  740.       +  When capturing data to a file already on disk, append the new data
  741.          to the old file.  The last block of the old file is searched for
  742.          the CP/M EOF character unless i or I term option is set.  The +
  743.          term option is reset at each command line and at each obey and
  744.          function key, pattern action, or downloaded command.  This term
  745.          option is not allowed if ZCOMM is Restricted.
  746.  
  747.       22.1  Real Time Status Line
  748.  
  749.       A real time status line is displayed when DOS and OS/2 ZCOMM are in
  750.       the term function.  The left part of this status line is also
  751.       displayed when ZCOMM is in Host Operation awaiting a call.
  752.  
  753.       The first character position shows a blinking W if the circular buffer
  754.       is being written to disk.  Otherwise, the first character position
  755.       shows an L if the keyboard has been locked by a kbdlock command, or C
  756.       if the Caps Lock key is activated.
  757.  
  758.       The second position shows an X if hardware handshaking is enabled and
  759.       Clear to Send (CTS) is not received from the modem, or if an XOFF
  760.       character has been received (software handshake).  This also happens
  761.       when a file upload is using the p term option with GOchar = 17 (17 is
  762.       decimal for XON) and ZCOMM has stopped at the end of a line.
  763.       Otherwise, an M is shown to indicate Keypad Mapped operation for
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc            Chapter 22 Term Function Status Line
  767.  
  768.  
  769.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  194
  771.  
  772.       terminal emulation.  Otherwise, an N appears if the Num Lock key is
  773.       activated and the K numeric parameter is 0 (84 key keyboard).
  774.       SEE ALSO: handshake command, Terminal Emulation, Chapter 29.
  775.  
  776.       The third position displays the real time status of the following five
  777.       conditions.  If more than one of the conditions is active at once, the
  778.       displayed character will represent the condition listed first.
  779.  
  780.       X   if the buffer has nearly filled up and ZCOMM has sent an XOFF to
  781.           suspend data transmission from the remote.
  782.  
  783.       E   when ZCOMM has sent an XOFF to suspend data transmission for Error
  784.           Containment(TM).
  785.  
  786.       S   if the term function is searching for one or more strings (defined
  787.           by the pattern command).
  788.  
  789.       W   if term is waiting for a character echo before resuming
  790.           transmission.
  791.  
  792.       w   if term is waiting for a fixed time before sending the next
  793.           character or returning from a putw or wait command.
  794.  
  795.       The display column and row numbers are displayed next with the home
  796.       position equivalent to 1, 1.  DOS's idea of the time of day is next.
  797.       The minutes of elapsed time follow the time of day, modulo 24 hours
  798.       (1440 minutes).  The elapsed time is reset by the ALT-E function key,
  799.       restime command, and telephone number autodial.
  800.  
  801.       If carrier detect is absent, an L( Local) appears after the elapsed
  802.       time.  The X.PC version will display c, p, or L in this position
  803.       depending on whether ZCOMM is in character state, packet state, or
  804.       Local (no carrier detect).
  805.  
  806.       The number of free characters in the Circular Buffer appears next.  If
  807.       a capture file is open, the number of characters written to the file
  808.       is displayed instead.  Otherwise, if a file is being uploaded ( f file
  809.       command), the number of characters sent is displayed instead of the
  810.       Circular Buffer free character count.
  811.  
  812.       A user programmed message may be displayed in right side of the status
  813.       line with the statliner string parameter.  Otherwise, the right side
  814.       of the status line shows the communications port,[7] transmission
  815.       speed ("baud rate") and the parity.
  816.  
  817.  
  818.  
  819.       __________
  820.  
  821.        7. Virtual channel number for X.PC
  822.  
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc            Chapter 22 Term Function Status Line
  826.  
  827.  
  828.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  195
  830.  
  831.       The next field represents the term options that are enabled.  If the
  832.       b, n, p, r, or w term option is set, that letter shows.  If p term
  833.       option is set with with GOchar equal to XON (decimal 17), a P is
  834.       shown.
  835.  
  836.       The v term option causes the view indicator to show ^ if control
  837.       characters are being displayed in the style ^C where C is the
  838.       alphabetic character corresponding to the control character.  The
  839.       indicator shows ~ if characters with the 8th bit set are being
  840.       displayed with a leading ~.
  841.  
  842.       Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z term options
  843.       causes the corresponding letter to be displayed.  The c, h, and s term
  844.       functions are displayed in upper case if their value is greater than
  845.       1.
  846.  
  847.       ON HOOK is displayed if the computer has disabled DTR (Data Terminal
  848.       Ready).  The speed command should be used to assert DTR and allow the
  849.       modem to go off hook (connect to line), e.g., "speed 1200".
  850.  
  851.       If a transmit file is open, a < followed by the transmit file name is
  852.       shown.
  853.  
  854.       If the file upload has been stopped by a grab command, Stopped(grab)
  855.       is diplayed.
  856.  
  857.       If a receive capture file is open, a > followed by the file name is
  858.       shown.
  859.  
  860.       EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424    1:1200 8n p^t <upload.fil
  861.       The keyboard has been "locked" by a kbdlock 1 command.  File upload
  862.       has been stopped by an XOFF character.  The cursor in in column 1,
  863.       line 24.  The elapsed time is 46 seconds.  Carrier is not present (L).
  864.       There are 31424 free bytes in the circular buffer.  Transmission speed
  865.       is 1200 bits per second.  Transmitted word length is 8 bits no parity
  866.       (8n).  Since a speed of 1200 selects 1 stop bit, operation is the same
  867.       as "8-N-1" mentioned by many bulletin board systems.  The p term
  868.       option makes file upload pause at the end of each line for a prompt
  869.       character.  View term option is set (ena -v).  Finally, t term option
  870.       slows the transmission of each character from a soft keys or file.
  871.       The disk file upload.fil is being uploaded.
  872.  
  873.       The s numeric parameter sets the status line display attribute.  The
  874.       default of 7 provides normal video.  With some displays, you can set
  875.       it to dim with a ps8 command so it won't distract you.  It may be
  876.       disabled with an "ESC x 1" sequence.
  877.  
  878.       SEE ALSO: statliner string parameter
  879.  
  880.  
  881.  
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc            Chapter 22 Term Function Status Line
  885.  
  886.  
  887.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  196
  889.  
  890.       22.1.1  X Windows status line  When operating under some versions of
  891.       the X Windows xterm program, Unix flavors display a status line
  892.       indicating Carrier Detect, elapsed time, and buffer free size.
  893.  
  894.       22.2  Conference Command/Local Editing
  895.  
  896.       When the conference command is given, two cursors appear.  The usual
  897.       cursor will follow text as it arrives from the remote computer.  A
  898.       block cursor in the conference window follows the text you enter.
  899.  
  900.       While entering text to the conference window, the standard ZCOMM
  901.       editing keys described in Chapter 18 may be used to correct
  902.       keyboarding mistakes.
  903.  
  904.       When you keyboard ENTER, LF, or ESC, or when you fill up the
  905.       conference window, ZCOMM queues the line for transmission.  The
  906.       conference window cursor disappears while the line is queued for
  907.       transmission.
  908.  
  909.       The line is transmitted as soon as the previous line (if any) has been
  910.       sent.  When transmission begins, the conference window is cleared and
  911.       the conference cursor reappears, allowing the next line to be
  912.       keyboarded.  Attempts to keyboard characters into the conference
  913.       window before transmission begins will ring the bell and be discarded.
  914.  
  915.       When in the conference command, the function keys operate the same way
  916.       as they normally do in the term function.  The review subcommands (F2,
  917.       PgUp, etc.) may be used to review portions of the conversation that
  918.       have scrolled off the main screen.  The exit command F1 causes any
  919.       characters entered in the conference window to be discarded.
  920.  
  921.       The following characters are passed directly to the remote and are not
  922.       entered into the conference window: ETX SI DLE XON XOFF DC2 DC4 (^C ^O
  923.       ^P ^Q ^S ^R ^T).
  924.  
  925.       Transmission from the conference window is controlled by the t, p, and
  926.       w term options and their associated parameters.  If none of these term
  927.       options are set, the line is transmitted at full speed.  If Half
  928.       Duplex term option h is set, ZCOMM echoes the line as it is
  929.       transmitted.  If H is set, a linefeed is transmitted and displayed
  930.       after the carriage return.
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                      Chapter 22 Review Function
  944.  
  945.  
  946.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  197
  948.  
  949.       23.  REVIEW FUNCTION
  950.  
  951.       Review function commands page, search, cut, paste, and otherwise
  952.       manipulate captured data stored in the circular buffer.
  953.  
  954.       The review function displays the approximate location of the displayed
  955.       text within the circular buffer as a percentage of the buffer contents
  956.       on the status line.  Unless i term option is in effect, escape
  957.       characters are printed as $ (dollar sign) so they will not interfere
  958.       with scrolling.
  959.  
  960.       Review subcommands consist of a single character preceded by an
  961.       optional numeric argument.  (The default value is 1.) The numeric
  962.       digits and the command are not echoed as they are entered.  For
  963.       example, keyboarding 69+ moves down 69 lines.
  964.  
  965.       You don't have to wait for the screen to fill before entering the next
  966.       review subcommand.  This comes in handy with the n subcommand.  Since
  967.       the N subcommand searches in the reverse direction, you can thumb
  968.       through messages (by searching for the subject header) very quickly,
  969.       knowing that you can back up if you went past something interesting.
  970.  
  971.  
  972.       23.1  Review Subcommands
  973.  
  974.       Defined soft keys are executed from review iff they do not conflict
  975.       with the permanent definitions.
  976.  
  977.       Ctrl-L, Ctrl-Home Ctrl-L (form feed) clears the screen and refreshes
  978.            the display without moving it.  Ctrl-L is useful after an error
  979.            printout within review, or after a subcommand that writes to the
  980.            screen such as ALT-D or ALT-S.
  981.  
  982.       a    Toggles the autowarp display mode, then refreshes the display.
  983.            If the autowrap display mode is enabled, long lines can be
  984.            viewed, but will cause lines at the top of the screen to scroll
  985.            off.
  986.  
  987.       G    Go to the Nth line and display from there.  If N is omitted, go
  988.            to the end instead.
  989.  
  990.       Home Display starting at the beginning of the capture buffer.
  991.  
  992.       r, R If a file is open as a result of a read command, read some more
  993.            of the file into the buffer, replacing about 3/4 of the previous
  994.            buffer contents (all if R subcommand).  A successful r subcommand
  995.            erases the pointers set by the t and b subcommands.  The data
  996.            read in from the file may overwrite the data currently displayed
  997.            on the screen.  In this case, ZCOMM displays data starting with
  998.            the oldest.
  999.  
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                      Chapter 23 Review Function
  1003.  
  1004.  
  1005.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  198
  1007.  
  1008.       F2, PgUp, ^B, * Display the Nth previous page (one line overlap is
  1009.            provided).
  1010.  
  1011.       SP, PgDn, ^F Clear screen and display the next Nth page.
  1012.  
  1013.       s, / Accept a search string, terminated by RETURN.  This string may
  1014.            have character escapes.  Search through the buffer for the Nth
  1015.            instance of string.  Lower case characters in string match either
  1016.            case; upper case characters in string match upper case characters
  1017.            only.  The display starts with that line.  If the search is
  1018.            unsuccessful, ring bell.  The search begins at the top of the
  1019.            display.
  1020.  
  1021.            SEE ALSO: ?, n, N subcommands
  1022.  
  1023.       ?    Prompts for search string as above, then searches backwards for
  1024.            the Nth occurrence of string starting with the line above the top
  1025.            of the buffer.
  1026.  
  1027.       n    Next searches for Nth occurrence of the previously entered string
  1028.            in the direction of the last "/" or "?" subcommand.  Typical
  1029.            usage would be to search for the first occurrence with the "/"
  1030.            subcommand, then use "n" to find more matches.
  1031.  
  1032.       N    Next searches for next Nth occurrence of the previously entered
  1033.            search string in the opposite direction to the original "/" or
  1034.            "?" subcommand.
  1035.  
  1036.       UpCursor, - Backup N lines and redisplay.
  1037.  
  1038.       DownCursor, +, Ctrl-J(LF) Move the display down N lines and redisplay.
  1039.  
  1040.       End  Go to the buffer end (where the most recent data is) and display.
  1041.  
  1042.       x    eXit returns to the previous function, and makes the term
  1043.            function redisplay the last page of buffer contents.[1] This
  1044.            restores the screen and keyboard to the same state they were in
  1045.            before review was entered.  The x subcommand allows you to see
  1046.            where you were if you were in the midst of keyboarding a command
  1047.            to the remote when you entered review.
  1048.  
  1049.            EXAMPLE: Suppose you are typing in a line of commands and you
  1050.            need to "thumb back" through the remote's output for some vital
  1051.            nugget of information.  (After you enter a 20 line email reply
  1052.  
  1053.  
  1054.       __________
  1055.  
  1056.        1. When the term function takes control, which is immediately if
  1057.           review was called from the term function.
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                      Chapter 23 Review Function
  1062.  
  1063.  
  1064.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  199
  1066.  
  1067.            message, NOW Compuserve asks you for a certain random 8 digit
  1068.            account number to mail it to!) No sweat, just hit some PgUp's
  1069.            until you see the account number on the screen.  Now you can't
  1070.            remember whether or not you typed a space after the last part of
  1071.            you command to the remote.  No problem, just exit review with x
  1072.            and you'll see just where you were.
  1073.            NOTE: This subcommand should not be used when scripts are active.
  1074.  
  1075.       k    Kill the capture buffer contents and return to the previous
  1076.            function.
  1077.  
  1078.       Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
  1079.            insertion pointer to just after the end of the current display.
  1080.            ZCOMM then redisplays the last lines of the buffer and returns to
  1081.            the previous function.
  1082.  
  1083.       t    Set the cut pointers to the top of displayed text, and sets the
  1084.            bottom cut pointer to the end of the buffer.  The t subcommand is
  1085.            used with the b subcommand to specify which portion of the
  1086.            circular buffer should be written to a file with the w
  1087.            subcommand.  (Text between the top and bottom pointers is
  1088.            highlighted.)
  1089.  
  1090.       b    Set the bottom pointer to the beginning of the first line of
  1091.            displayed text.  If the top pointer had not been previously set,
  1092.            or if the bottom pointer is before the top pointer, ZCOMM will
  1093.            ring the bell and ignore the subcommand.  Otherwise, the text on
  1094.            the screen that was highlighted will now be displayed in normal
  1095.            intensity as what is showing on the screen has just been
  1096.            deselected.  (Text between the top and bottom pointers is
  1097.            highlighted.)
  1098.  
  1099.       w, W Write (paste) the text between the top and bottom pointers to a
  1100.            disk file or DOS device.[2] If the top pointer is not set, a
  1101.            reminder is printed.  ZCOMM prompts for a pathname.  A blank file
  1102.            name implies the modem.[3] If the bottom pointer is not set, the
  1103.            rest of the buffer will be written.  No log entry is made by this
  1104.            subcommand.  The W subcommand automatically appends the paste
  1105.            data to an existing file.  A directory for past files may be
  1106.            specified with the DIRPX environment variable and/or the dirpx
  1107.  
  1108.  
  1109.       __________
  1110.  
  1111.        2. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
  1112.  
  1113.        3. Data is sent to the modem at full speed with the current parity.
  1114.           Normally, line feeds are not sent.  With n term option, line feeds
  1115.           are sent and carriage returns are suppressed.  With b term option,
  1116.           data is sent the way it was received.
  1117.  
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                      Chapter 23 Review Function
  1121.  
  1122.  
  1123.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  200
  1125.  
  1126.            string parameter.
  1127.  
  1128.       q, F1, ALT-X Quit, return to previous function.
  1129.  
  1130.       !    Prompts for a DOS command, then attempts to execute it (DOS
  1131.            Gateway).
  1132.  
  1133.       @    Prompts for a ZCOMM command, then executes it.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                   Chapter 23 Numeric Parameters
  1180.  
  1181.  
  1182.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  201
  1184.  
  1185.       24.  NUMERIC PARAMETERS
  1186.  
  1187.       Numeric parameters are set with the p command in the form px# where x
  1188.       is the one letter name of the parameter and "#" is the numeric value.
  1189.  
  1190.       Numbers may have an optional leading "-" (minus) sign.  Numbers are
  1191.       normally decimal, but hex numbers may be input as 0xHH, printing ASCII
  1192.       character values may be entered as 0cC, and control characters may be
  1193.       represented as 0^C.
  1194.  
  1195.       Value     Possible entries
  1196.       65   65  0x41  0cA
  1197.       3    3  0x3  0^C
  1198.  
  1199.       Typing "p" without a parameter name displays the current values of the
  1200.       numeric parameters in decimal.
  1201.  
  1202.       EXAMPLE: pS5 sets the timeout interval in seconds waiting for XON
  1203.       characters or positive flow control.  to decimal 5 seconds.
  1204.  
  1205.  
  1206.       EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
  1207.       routine messages
  1208.  
  1209.  
  1210.       #  The # numeric parameter sets the number of lines used by the built
  1211.          in display driver.  The default value is 24.  A value of 25 may be
  1212.          used for applications which require access to all 25 display lines.
  1213.          A small value may be used when running ZCOMM under TopView to fit
  1214.          the information into a small window.  The cls or reset command
  1215.          should be given after setting the parameters to initialize the
  1216.          screen driver to the new values.  If running with a virtual screen
  1217.          with TopView or DESQview, the # and $ numeric parameters are
  1218.          limited to 24 by 80 maximum.  Full screen applications may give
  1219.          abnormal displays if these parameters are set too small.
  1220.          Nonsensical values tend to produce nonsensical displays.
  1221.  
  1222.          EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
  1223.          and initializes the screen driver to the new value.
  1224.  
  1225.       $  Sets the number of CRT columns.  A cls or reset command should be
  1226.          given after changing the $ numeric parameter.  The default value
  1227.          (80) is that returned by the BIOS video interrupt 15h call.  This
  1228.          parameter may be set to support 132 column displays if the 132
  1229.          column display mode is set before ZCOMM is called.[1] ZCOMM does
  1230.  
  1231.  
  1232.       __________
  1233.  
  1234.        1. With most display BIOS ROMs, ZCOMM reads the columns and lines
  1235.           values from the BIOS when starting up or regaining control after a
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1239.  
  1240.  
  1241.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  202
  1243.  
  1244.          not support displays less than 80 columns wide.  The display
  1245.          hardware must use the same number of columns as the $ parameter if
  1246.          the resultant presentation is to make any sense.
  1247.  
  1248.          SEE ALSO: # and V numeric parameters
  1249.  
  1250.       -  If non zero, the DOS Gateway (used with the ! command, etc.) uses
  1251.          the undocumented DOS 37h function to fetch the current value of
  1252.          SWITCHAR.
  1253.  
  1254.          If negative, ZCOMM uses DOS line input (function 0xA) for commands
  1255.          given from the main prompt.  This enables DOS command line editors
  1256.          such as CED.  When these editors are active, they (and not ZCOMM)
  1257.          interpret control, function and ALT- keys.
  1258.  
  1259.       *  Sets the CRT attribute for highlighted messages.
  1260.  
  1261.          EXAMPLE: p*12 gives bright red.
  1262.  
  1263.          Adding 1024 to this parameter forces ANSI SGR 1 to use this color.
  1264.  
  1265.       ?  Count of the number of files sent or received with a protocol, and
  1266.          the number of lines matched by the find command.  A failed password
  1267.          validation sets this negative.  The exit status of subprograms is
  1268.          stored in this parameter.  Because of a bug in DOS COMMAND.COM, the
  1269.          return value is valid only with Unix/Xenix flavors.
  1270.  
  1271.          SEE ALSO: ?  test condition
  1272.  
  1273.       @  Sets the CRT attribute for the (normally) blinking messages such as
  1274.          FILES OPEN.  The numeric values are explained below, with the n
  1275.          numeric parameter.
  1276.  
  1277.          EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
  1278.          bright red.
  1279.  
  1280.          Adding 1024 to this parameter forces ANSI SGR 5 and 6 to use this
  1281.          color.
  1282.  
  1283.       A  If non 0, selects a prefix character which allows ALT characters to
  1284.          be generated by keyboards without ALT keys.  This parameter is
  1285.          supported on VAX/XMS and Unix platforms; please refer to the
  1286.          platform specific addendum file for specifics.
  1287.  
  1288.  
  1289.  
  1290.  
  1291.       ______________________________________________________________________
  1292.  
  1293.           DOS Gateway.
  1294.  
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1298.  
  1299.  
  1300.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  203
  1302.  
  1303.       B  If set non zero (the default), causes a bye command to be issued
  1304.          each time a telephone number is executed as a command.
  1305.  
  1306.          SEE ALSO: mcommand string parameter, number dialing commands
  1307.  
  1308.       C  If non zero, only display C ESC sequences per screen in the Review
  1309.          Function, and count escape sequences when advancing or backing up
  1310.          in the review buffer.  Otherwise, ESC sequences are not counted.
  1311.  
  1312.       D  A nonstandard raw bit rate source is required to support
  1313.          transmission speeds above 115200, as well as intermediate bit rates
  1314.          (64000, 156000).  Non standard raw bit rate sources can be
  1315.          accomodated with the
  1316.  
  1317.       E  If non 0, substitute this for characters with bad parity detected
  1318.          by the term function with e term option (Error Containment(TM)).
  1319.  
  1320.          EXAMPLE: ena -7e;  pE63 Substitute ?  for characters received with
  1321.          odd parity.
  1322.  
  1323.  
  1324.       F  Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.
  1325.  
  1326.          EXAMPLE: pF8 gives gray.
  1327.  
  1328.  
  1329.       G  This parameter controls the number of bytes loaded into the 16550A
  1330.          transmit FIFO (First In First Out) storage register on each
  1331.          interrupt.  This parameter is effective only with PCDOS machines
  1332.          using FIFO buffered UART devices.
  1333.  
  1334.          For maximum efficiency, ZCOMM fills the 16 byte transmit FIFO when
  1335.          the UART generates a FIFO Empty interrupt.  Once loaded, data
  1336.          transmission from the transmit FIFO cannot be stopped. Many bytes
  1337.          may be sent after the modem sends XOFF or asserts hard flow control
  1338.          restraint.  Well engineered modems accept a large number of bytes
  1339.          after exerting flow control restraint, but some don't.
  1340.  
  1341.          The number of bits in the binary representation of this parameter
  1342.          are counted to control the number of bytes loaded into the FIFO
  1343.          each time the 16550A interrupts with an empty transmit FIFO
  1344.          register.  To improve Zcomm's responsiveness to flow control
  1345.          restraint, set this parameter to 0.
  1346.  
  1347.          EXAMPLE: pG0
  1348.  
  1349.  
  1350.       H  In Host Operation, sets the timeout in seconds for entering a
  1351.          command or string in response to a command or other prompt,
  1352.          including the accept command.  A value of 0 (the default) disables
  1353.          this timeout.
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1357.  
  1358.  
  1359.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  204
  1361.  
  1362.       I  Set the size of disk I/O buffer used for protocol file transfers.
  1363.          Suitable values are 2048, 4096, 8192, and 16384.  It may be
  1364.          necessary to specify a CBSIZE environment variable larger than
  1365.          10240 to prevent the circular buffer from competing with disk I/O
  1366.          buffers for near heap space.  Too large a value may exhaust memory,
  1367.          induce receiver timeouts, cause disconnects(!), or generate
  1368.          spurious errors on file transfers.
  1369.  
  1370.          If your copy of ZCOMM is running on a floppy disk system or a slow
  1371.          hard disk, a larger value may give better results.  A large value
  1372.          may also be used in extra high speed direct connect file transfers
  1373.          where the I and the zmodem l numeric parameters are both set to
  1374.          8192 or 16384 on the receiving system.
  1375.  
  1376.          EXAMPLE: pI4096
  1377.  
  1378.  
  1379.          Please understand that the B parameter has nothing to do with
  1380.          anything you've heard about 128, 1024 or 8192 byte XMODEM style
  1381.          blocks.  Normally, ZMODEM's block size is the entire file.
  1382.  
  1383.       K
  1384.  
  1385.          PCDOS On the PCDOS flavor, if non 0, executes keyboard BIOS calls
  1386.               to recover extended codes from 101 key keyboards.  This causes
  1387.               lockups with defective BIOS versions.
  1388.  
  1389.          UNIX/VMS On Unix and VMS flavors, when ZCOMM reads an ESC character
  1390.               and the K numeric parameter is 1 (the default), succeeding
  1391.               characters in the keyboard buffer are read to detect encoded
  1392.               function or ALT keys.
  1393.  
  1394.               If the K numeric parameter is set to 0, ZCOMM will not
  1395.               recognize escape codes representing function keys, allowing
  1396.               the function key codes to be passed to the remote computer.
  1397.               Setting the K numeric parameter to 0 activates the term
  1398.               function's special processing of ENQ (Ctrl-E) and SYN (Ctrl-
  1399.               V).
  1400.  
  1401.       N  When enabled with display mapkb, this parameter controls the
  1402.          relationship between ANSI/VT52 Alternate Keypad mode (DECKPAM,
  1403.          ESC=), ANSI Numeric Keypad mode (DECKPNM, ESC>), and the PC's
  1404.          keyboard Num-Lock state.
  1405.  
  1406.          0  causes ZCOMM to set the PC's keyboard Num_Lock state to match
  1407.             Numeric Keypad mode when DECKPNM or DECKPAM is received.
  1408.  
  1409.          32 causes ZCOMM to set the PC's keyboard Num_Lock state to the
  1410.             opposite of Numeric Keypad mode when DECKPNM or DECKPAM is
  1411.             received.
  1412.  
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1416.  
  1417.  
  1418.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  205
  1420.  
  1421.          1  causes ZCOMM to set the PC's keyboard Num_Lock on in response to
  1422.             either DECKPNM or DECKPAM.
  1423.  
  1424.          2  causes ZCOMM to set the PC's keyboard Num_Lock off in response
  1425.             to either DECKPNM or DECKPAM.
  1426.  
  1427.          SEE ALSO: display, mk and ALT-M commands
  1428.  
  1429.       O  Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM,
  1430.          and YMODEM-1k downloads.  This parameter should be set as follows:
  1431.  
  1432.          CompuServe XMODEM OverThruster is known to be effective on
  1433.               CompuServe.  Negative numbers control the number of bytes
  1434.               added to the window on XMODEM downloads from the network.
  1435.               Larger numbers increase throughput, but cause improperly
  1436.               interfaced MNP modems and network nodes to drop characters
  1437.               under stress, disrupting the file transfer.
  1438.  
  1439.               EXAMPLE: pO-512; ro file1.ext
  1440.  
  1441.  
  1442.          Other XMODEM Positive numbers up to a system dependent value less
  1443.               than the protocol block size increase throughput.  Larger
  1444.               values induce timeouts and/or retransmitted blocks.  The
  1445.               optimum value must be determined by experiment.  If you see
  1446.               the message: Retry 0:  Received dup Sector very often, the
  1447.               value should be reduced.  60 usually give best results with
  1448.               MNP modems at 2400 bps.  The optimum value varies depending on
  1449.               the remote computer, modem(s), system traffic, and the network
  1450.               node.
  1451.  
  1452.               EXAMPLE: pO60; ro file1.ext
  1453.  
  1454.  
  1455.       P  After a "speed" command, if you give a p command (display
  1456.          parameters), the P parameter value will indicate the type of serial
  1457.          I/O UART chip detected.  ZCOMM automatically detects and enables
  1458.          the FIFO on the NS16550A, NS16550AFN, and Intel 82510 chips.
  1459.  
  1460.          EXAMPLE: Zcomm port 1 speed 19200 p
  1461.  
  1462.  
  1463.          0  Indicates a standard 8250 or 16450 UART with no special
  1464.             features.
  1465.  
  1466.          1  Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO.
  1467.             These are the preferred chips.
  1468.  
  1469.          2  Indicates an Intel 82510 with 3 deep receive FIFO.
  1470.  
  1471.          The sequence "port 1 pP1 speed 19200" bypasses ZCOMM's verification
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1475.  
  1476.  
  1477.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  206
  1479.  
  1480.          checks normally performed on the FIFO configuration and may allow
  1481.          defective FIFO logic on certain chips to be used.  This incantation
  1482.          is not required for the NS16550AN or NS16550AFN.
  1483.  
  1484.          The sequence "pP-1 speed 2400" should be used with the Western
  1485.          Digital WD16550 chip to disable the brain damaged FIFO on that
  1486.          chip. The WD16550 FIFO has been observed to lose data when
  1487.          transmitting at 2400 bps and slower speeds.  The minimum speed for
  1488.          normal transmit FIFO operation with the WD16C550 may vary with
  1489.          different computers.
  1490.  
  1491.       Q  PCDOS VIDEO BIOS display mode to switch the display to 80 columns.
  1492.          Default is 3 (80x25).
  1493.  
  1494.       R  If non zero, remove incomplete files received with a protocol
  1495.          except those received with the + option (default 0).
  1496.  
  1497.       S  Timeout interval in seconds waiting for XON characters or positive
  1498.          flow control (default 30).  If an XON is not received within this
  1499.          time, transmission resumes anyway.  A value of 0 disables this
  1500.          timeout.
  1501.  
  1502.       T  If Command Reentry has been enabled with the history command, the T
  1503.          parameter prevents commands with fewer than T characters from being
  1504.          stored in the history file.  Excluding short and easy to type
  1505.          commands from the history file makes it easier to find the commands
  1506.          that are difficult to keyboard.
  1507.  
  1508.          Setting T to a large number disables the storage of commands and
  1509.          strings.  This may be used to exclude passwords and other sensitive
  1510.          information from the history file.
  1511.  
  1512.          SEE ALSO: history command
  1513.  
  1514.       V  PCDOS VIDEO BIOS display mode to switch the display to 132 columns
  1515.          in response to a VT-100 DECCOLM mode set command.  To support
  1516.          boards using an extended code in the bl register, calculate N = bl
  1517.          + (256 * al).
  1518.  
  1519.          A popular value is 35 for the Tseng, ATI, and other extended EGA
  1520.          boards.  The Genoa Super EGA Hi-Res likes 96.  The Everex EVGA uses
  1521.          28684.  The default value of 0 inhibits this function.
  1522.  
  1523.       W  This numeric parameter supports Video7 and similar boards which
  1524.          require a non 0 value in the AH register on INT 10h bios calls for
  1525.          setting video modes (e.g., 132 columns).  The value of the W
  1526.          numeric parameter (default 0) is placed in the AH register when
  1527.          attempting to switch video modes.
  1528.  
  1529.       X  On Unix flavors, preset to +1 if the XTERM environment variable
  1530.          contains xterm, preset to -1 if the variable contains the string
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1534.  
  1535.  
  1536.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  207
  1538.  
  1539.          401 indicating a Tektronix storage tube graphics terminal,
  1540.          otherwise remains at 0.  Positive values allow the term function to
  1541.          use the X Windows xterm status line.  Negative values inhibit
  1542.          status line updates while Tek graphics are active.
  1543.  
  1544.       Y  Control byte for the NS16550AN/NS16550AFN FCR register.  If you
  1545.          don't know what the FCR does, don't change this parameter.  It has
  1546.          been suggested that a different value (129) may improve
  1547.          multitasking under DESQview when multiple copies of ZCOMM are
  1548.          active.
  1549.  
  1550.       Z  Hot zone column used for keyboard entry with the message and
  1551.          privatecommands.  A space character keyboarded within the hot zone
  1552.          finishes the line.
  1553.  
  1554.       a  The a parameter calibrates certain XMODEM and YMODEM protocol
  1555.          timeouts.  The default value is set during initialization to an
  1556.          appropriate value for an IBM Personal Computer, PC-jr, DG/One, or
  1557.          8mHz PC-AT (2000 for 4.77 mHz PC, 4000 for a PS2/30, 6000 for an 8
  1558.          mHz AT, 12000 for a PS2/80).  If ZCOMM is run on a non standard
  1559.          machine, accelerator, or under a time slicing operating environment
  1560.          such as TopView, these timeouts may be recalibrated with the a
  1561.          numeric parameter.  Larger numbers give longer timeouts.  This
  1562.          parameter should then be set with a pa# command in the telephone
  1563.          directory setup entry.  The value for this parameter will change if
  1564.          ZCOMM is used with a different computer type or multitasking
  1565.          operating system.
  1566.  
  1567.       b  Sets the video color for the screen border.  The mapping of b
  1568.          parameter values to color is hardware dependent.  New values of the
  1569.          b parameter take effect with the next screen clear.
  1570.  
  1571.       c  The c parameter sets the callout interval in seconds between scans
  1572.          for outgoing messages.  The default is 300 seconds (five minutes).
  1573.  
  1574.          EXAMPLE: pc600 sets the interval between callout queue scans to 10
  1575.          minutes.
  1576.  
  1577.  
  1578.          SEE ALSO: Callout queue
  1579.  
  1580.       d  A non zero value (the default) causes incoming files received with
  1581.          ZMODEM and full YMODEM Batch protocol to have their Date set to
  1582.          that sent in the file header.  ZMODEM's file management features
  1583.          depend on the transmission of each file's modification date.  Files
  1584.          between two copies of ZCOMM will have the same creation date, even
  1585.          if the two machines are in different time zones.  When transferring
  1586.          files to/from a Unix system, creation dates are interpreted
  1587.          according to GMT or Universal Coordinated Time.  File dating should
  1588.          be enabled with a pd1 command in the telephone directory setup
  1589.          entry.
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1593.  
  1594.  
  1595.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  208
  1597.  
  1598.          SEE ALSO: z numeric parameter, ZONE environment variable
  1599.          NOTE: Backdating file creation times may confuse some backup
  1600.          programs.
  1601.  
  1602.       e  Indicates the number of errors, failed file transfers and the
  1603.          number of characters received by the term function with parity
  1604.          error, framing error or overrun.
  1605.  
  1606.          EXAMPLE: if e>30 goto badline
  1607.  
  1608.  
  1609.          If the term function increments the error count to 0[2] (from a
  1610.          negative number), and E term option is set, the term function
  1611.          exits. This allows the script to regain control in the event of a
  1612.          noisy line.  This condition is indicated by the e test condition
  1613.          being false (0).
  1614.  
  1615.          EXAMPLE: pe-20; ... wait; if !e goto badline
  1616.  
  1617.  
  1618.          This parameter is reset to 0 by the call command.
  1619.  
  1620.          SEE ALSO: E term option
  1621.  
  1622.          SEE ALSO: e test condition (if, while commands)
  1623.  
  1624.          Unless the q file transfer option is used, each file skipped as a
  1625.          result of ZMODEM selective transfer increments this parameter.
  1626.  
  1627.       f  Fail time.  Sets the default timeout in seconds for matching a
  1628.          pattern.  A value of 0 suppresses this timeout.  This timeout is
  1629.          reset whenever a character is received from the remote.  Timeout is
  1630.          suspended whenever a XOFF (DC3 or Control-S) is keyboarded, and
  1631.          resumed when XON (DC1 or Control-Q) is keyboarded.  The f parameter
  1632.          value may be overridden for one command by the ftime term option.
  1633.  
  1634.          EXAMPLE: pf15 sets a default 15 second inactivity timeout  for
  1635.          pattern searches.
  1636.  
  1637.  
  1638.       g  Set the "gochar" (decimal).  (See the ASCII/Decimal conversion
  1639.          table in Chapter 37).  The g parameter is reset to its default
  1640.          (linefeed, 10) by the call command.  (See documentation on the p
  1641.          term option.)
  1642.  
  1643.  
  1644.  
  1645.       __________
  1646.  
  1647.        2. Refer to E term option description for caveats.
  1648.  
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1652.  
  1653.  
  1654.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  209
  1656.  
  1657.          Some remote systems accept uploads with a ? (decimal 63) prompt for
  1658.          each line.  Optimum operation with such a system might call for
  1659.  
  1660.               pg63 pp1000 pt4 f -tp file1
  1661.  
  1662.          The pg63 sets the goahead character to question mark.  The pp1000
  1663.          sets the timeout to a long delay (10 seconds).  The pt4 sets the
  1664.          upload throttle to 40 milliseconds per characters, a speed which
  1665.          allows the remote to echo somewhat slowly (assuming no tabs).
  1666.          Finally, the command f -tp file sends file1 with Throttle and wait
  1667.          for Prompt at end of line.
  1668.  
  1669.          As a special case, if the "gochar" is set to 17 (called XON, DC1,
  1670.          or ^Q) before the p term option is set, file transmission is
  1671.          stopped until an XON is keyboarded or received from the remote.
  1672.  
  1673.          EXAMPLE: pg17; ena -p
  1674.  
  1675.  
  1676.       h  Iff the h numeric parameter is set non zero, the h (Half Duplex)
  1677.          termoption causes characters transmitted by the term function to be
  1678.          stored in the circular buffer as if they had been received from the
  1679.          remote.  This allows the review function to display them.  Since
  1680.          the echoed characters appear to have come from the remote, scripts
  1681.          may be affected, especially pattern searches.
  1682.  
  1683.          EXAMPLE: ph1; ena -h
  1684.  
  1685.  
  1686.       i  Set the interval between retries to n seconds.
  1687.  
  1688.          EXAMPLE: pi4; call -200 busysys attack dials up to 201 times at 4
  1689.          second intervals.
  1690.  
  1691.  
  1692.          SEE ALSO: call -n command
  1693.  
  1694.       j  Sets the maximum connect time in seconds allowed restricted callers
  1695.          in host operation.  The default value of 0 does not restrict
  1696.          connect time.
  1697.  
  1698.          EXAMPLE: pj300 disconnects restricted callers at the first command
  1699.          prompt after 5 minutes' connect time.
  1700.  
  1701.  
  1702.       k  When receiving data from the remote at high speeds (9600 or
  1703.          faster), the display may fall behind data from the remote.  Under
  1704.          these conditions, keyboarding an interrupt character (often Ctrl-C,
  1705.          or Break) will immediately stop the output from the remote, but the
  1706.          display will continue to scroll for some time while the data in the
  1707.          circular buffer is displayed.  If this is objectionable, the k
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1711.  
  1712.  
  1713.       Version 18.07 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  210
  1715.  
  1716.          parameter may be set to the remote's particular interrupt character
  1717.          (in decimal).  This parameter also affects the link command.  When
  1718.          this character is keyboarded, undisplayed data pending in the
  1719.          circular buffer is skipped over.  (This data is still available to
  1720.          the review command.  The call command resets this parameter to -1,
  1721.          disabling its function.
  1722.  
  1723.          EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs.
  1724.          Many Unix users also use ETX for interrupting programs.  The
  1725.          command pk3 causes ZCOMM to skip buffered output from the remote.
  1726.          Unix users using the default interrupt character of RUBOUT may give
  1727.          the command pk127
  1728.  
  1729.  
  1730.       l  Selects LPTn for term function output when the l term option is
  1731.          set.  In addition, adding 8 to the number allows terminal emulation
  1732.          escape codes (DEC "media copy enter printer controller") to select
  1733.          "printer controller" mode iff the printer is ready at the time.
  1734.          Adding 16 to the number allows "printer controller" mode to be
  1735.          selected even if the printer is not ready at the time.
  1736.  
  1737.          As a special case, setting this parameter to 0 forces ZCOMM to use
  1738.          DOS handle 4 (STDPRN, device PRN:) for printer output.  Doing so
  1739.          may generate spurious "Abort, Retry, Ignore, Fail" messages from
  1740.          some versions of DOS.  DOS 5.0 generates spurious "Write Fault"
  1741.          messages with some parallel port adapters; changing from the
  1742.          parallel port on an AST Advantage board to a recent Chinese "AT
  1743.          Multi I/O" board eliminated the DOS error messages.
  1744.  
  1745.          When using DOS handle 4 for printing, a legitimate printer problem
  1746.          will generate the "Abort, Retry, Ignore, Fail" message.  Normally
  1747.          you would wish to correct the printer problem and keyboard "r" for
  1748.          Retry.  If the printer problem cannot be corrected, keyboard "f"
  1749.          (Fail) a few times and ZCOMM will disable printing by setting the l
  1750.          numeric parameter to -1.  Printing can be enabled later by
  1751.          resetting the l numeric parameter.
  1752.  
  1753.          The default value is 1 (BIOS LPT1, ignore terminal emulation
  1754.          printer commands).
  1755.  
  1756.          EXAMPLE: pl2 selects LPT2.
  1757.  
  1758.  
  1759.          EXAMPLE: pl9 selects LPT1 and allows the remote application to
  1760.          enable "auxiliary print" and/or "printer controller" mode.
  1761.  
  1762.       m  Causes file transmission with the f file command to pause when a
  1763.          character matching the decimal value is read from the file.  That
  1764.          character is NOT transmitted.  When the file uploading is paused, a
  1765.          keyboarded Ctrl-Q will resume transmission.  The call command
  1766.          resets the m parameter to -1 (which matches nothing).
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  1770.  
  1771.